home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / source / vr386 / pointer.h < prev    next >
Encoding:
C/C++ Source or Header  |  1994-01-10  |  6.7 KB  |  181 lines
  1. /* Definition for a generic 3-D pointing device interface */
  2.  
  3. /* Written by Dave Stampe Aug. 92 */
  4.  
  5. // this is for inclusion where PDRIVER def,n not needed
  6.  
  7. // pointers are a generic device interface, designed so YOUR
  8. // pointer code can be very simple.  Scaling, transforms and
  9. // so on are all done in VR-386.
  10.  
  11. // PUT IN FILE BEFORE VR-API.H
  12.  
  13.  
  14. /*
  15.  This code is part of the VR-386 project, created by Dave Stampe.
  16.  VR-386 is a desendent of REND386, created by Dave Stampe and
  17.  Bernie Roehl.  Almost all the code has been rewritten by Dave
  18.  Stampre for VR-386.
  19.  
  20.  Copyright (c) 1994 by Dave Stampe:
  21.  May be freely used to write software for release into the public domain
  22.  or for educational use; all commercial endeavours MUST contact Dave Stampe
  23.  (dstampe@psych.toronto.edu) for permission to incorporate any part of
  24.  this software or source code into their products!  Usually there is no
  25.  charge for under 50-100 items for low-cost or shareware products, and terms
  26.  are reasonable.  Any royalties are used for development, so equipment is
  27.  often acceptable payment.
  28.  
  29.  ATTRIBUTION:  If you use any part of this source code or the libraries
  30.  in your projects, you must give attribution to VR-386 and Dave Stampe,
  31.  and any other authors in your documentation, source code, and at startup
  32.  of your program.  Let's keep the freeware ball rolling!
  33.  
  34.  DEVELOPMENT: VR-386 is a effort to develop the process started by
  35.  REND386, improving programmer access by rewriting the code and supplying
  36.  a standard API.  If you write improvements, add new functions rather
  37.  than rewriting current functions.  This will make it possible to
  38.  include you improved code in the next API release.  YOU can help advance
  39.  VR-386.  Comments on the API are welcome.
  40.  
  41.  CONTACT: dstampe@psych.toronto.edu
  42. */
  43.  
  44.  
  45. #define PTRDEF 1
  46.  
  47. #ifndef PTRBDEF
  48. #define PTRBDEF 1
  49.  
  50. typedef void pconfig;
  51. #include "vr_ctype.h"
  52.  
  53. #define P_HASB1    0x0001   /* what buttons we can have  */
  54. #define P_HASB2    0x0002   /* also mask for button bits */
  55. #define P_HASB3    0x0004
  56. #define P_HASX     0x0008   /* which axes we can read */
  57. #define P_HASY     0x0010
  58. #define P_HASZ     0x0020
  59. #define P_HASRX    0x0040   /* what rotations are available */
  60. #define P_HASRY    0x0080
  61. #define P_HASRZ    0x0100
  62. #define P_HASGEST  0x0200   /* gestural interface   */
  63. #define P_HASFLEX  0x0400   /* fingers?             */
  64. #define P_HASKEYS  0x0800   /* do we have a keypad? */
  65. #define P_HASSCR   0x1000   /* capable of emulating XY mouse */
  66.  
  67.  
  68. /* commands to driver (modes): */
  69.  
  70. #define P_CENTER    1   /* recenter without reinitializing */
  71. #define P_SCREEN    2   /* screen mouse mode read     */
  72. #define P_POINTER   4   /* any extended pointing mode */
  73.  
  74. /* type: bits specifying suggested uses */
  75.  
  76. #define P_NOPOS 0   /* just a keypad or something */
  77. #define P_IS2D  1   /* 2D mouse, for example      */
  78. #define P_IS2DP 2   /* 2D, but Z mapped by button */
  79. #define P_IS3D  4   /* 3D mouse, for example      */
  80. #define P_IS6D  8   /* 6D mouse, for example      */
  81. #define P_IS3DG 16  /* 3D glove-- don't use rot   */
  82. #define P_IS6DG 32  /* 6D glove-- use rotation    */
  83. #define P_IS3RH 64  /* 3D (rotation) head tracker */
  84. #define P_IS3TH 128 /* 3D (position) head tracker */
  85. #define P_IS6H  256 /* full 6D head tracker       */
  86.  
  87.  
  88.  
  89. /* driver interface packet */
  90.  
  91. typedef struct _pt{
  92.     long x, y, z;          /* location in scaled coordinates     */
  93.     long dx, dy, dz;       /* position change from last read     */
  94.     long rx, ry, rz;       /* scaled orientation around x, y, z  */
  95.     long drx, dry, drz;    /* orientation change from last read  */
  96.     unsigned buttons;      /* 16 bits: raw mouse buttons         */
  97.     unsigned gesture;      /* glove gesture ID, or a mapping     */
  98.     unsigned keys;         /* keypad return value                */
  99.     int flex[16];          /* 16 words of flexion (i.e. fingers) */
  100.     int changed;
  101.     int wpos_valid;        /* set if world pos'n is valid        */
  102.     MATRIX wpos;           /* world position/rotation            */
  103.     } POINTER;
  104.  
  105. typedef void PDRIVER ; /* points to driver data block */
  106.  
  107.                 /* loads driver, initializes   */
  108.                 /* return NULL if failure      */
  109.                 /* drfile is NULL for internal */
  110.                 /* type gives preferred mode   */
  111. extern PDRIVER *pointer_init(int type, char *drfile);
  112.  
  113.                 /* makes sure device is available, OK */
  114.                 /* returns *pconfig or NULL           */
  115. extern pconfig *pointer_check(PDRIVER *p);
  116.  
  117.                 /* reads pointer, scales data and        */
  118.                 /* returns bitwise OR of the following:  */
  119. extern int pointer_read(PDRIVER *p, POINTER *pointer);
  120.  
  121. #define PNEW_POS  1   /* raw xyz change           */
  122. #define PNEW_ROT  2   /* raw rot. change          */
  123. #define PNEW_BUT  4   /* button pressed/released  */
  124. #define PNEW_GEST 8   /* gesture change           */
  125. #define PNEW_KEY  16  /* new key pressed/released */
  126. #define PNEW_FLEX 32  /* new flexion              */
  127.  
  128.             /* recenters, recalibrates, etc */
  129. extern void pointer_reset(PDRIVER *p);
  130.  
  131.             /* disconnects driver */
  132. extern void pointer_quit(PDRIVER *p);
  133.  
  134.             /* changes device mode */
  135. extern pconfig *device_command(PDRIVER *p, int command);
  136.  
  137.             /* sets scaling (+/- given value) */
  138.  
  139. extern void pointer_tscale(PDRIVER *p, long x, long y, long z);
  140. extern void pointer_rscale(PDRIVER *p, long rx, long ry, long rz);
  141.  
  142.  
  143. extern void pointer_abscale(PDRIVER *p, long xs, long ys, long zs,
  144.     long rxs, long rys, long rzs);
  145.  
  146.             /* uses internal tick-resolution scaling for abs. devices */
  147. extern void init_pointer(POINTER *p); /* presets pointer structure */
  148.  
  149. extern int last_pointer(PDRIVER *d,POINTER *p); /* copy of last read value */
  150.  
  151.              /* mouse-emulation read: return change flags for button, pos'n */
  152. extern int mouse_read(PDRIVER *p, int *x, int *y, unsigned *b);
  153.  
  154.              /* mouse-emulation get last data: return change flags for button, pos'n */
  155. extern int mouse_last(PDRIVER *p, int *x, int *y, int *b);
  156.  
  157. extern void set_mouse_limits(PDRIVER *p, int maxx, int maxy);
  158.  
  159. /* driver call equates: call *driver_pointer with this code */
  160. /* all return *pconfig or integer */
  161.  
  162. #define DRIVER_INIT  0   /* rtns *pconfig, args = type    */
  163. #define DRIVER_RESET 1   /* no rtn, no args               */
  164. #define DRIVER_READ  2   /* rtns NULL if no data ready, else *pconfig */
  165.                         /* args = *pointer, mode */
  166. #define DRIVER_CMD   3   /* args = mode, rtns *pconfig    */
  167. #define DRIVER_CHECK 4   /* no args, rtns *pconfig        */
  168. #define DRIVER_QUIT  5   /* no args, no rtn               */
  169.  
  170. extern PDRIVER *mouseptr_init(char *name);
  171.  
  172.  
  173. #define SW_INIT        0        // commands to switch ptr driver
  174. #define SW_QUIT        1
  175. #define SW_ADV_SWITCH  2
  176. #define SW_SYNC_SWITCH 3
  177.  
  178.  
  179. /* End of pointer.h */
  180.  
  181. #endif